
    --============================================================================--
  |||                                 OILS WELL                                    |||
    --============================================================================--
                             Copyright SCORPION SOFTWARE


A remake of OILS WELL by Sierra Online 1983, with some added extras, like new 
enemies and new levels. I also added a custom made highscore screen.


-- Info --
Status         : Final version (unless I find bugs)
Website        : http://www.jrxs.net


-- Credits --
Original game by by Sierra Online.
Most graphics I took from the Colecovision version. Some graphics I made myself.
Also the sounds are ripped from either the Colecovision version of the C64 version.

Coding    : Joeri Roels
Music/sfx : Colecovision/C64
Graphics  : Colecovision/Joeri Roels

If you want to contact me (comments, bug reports, etc), drop me an email at:
jrlsx@hotmail.com


This game works on Windows and Android systems.
Tested on OUYA and Nvidia Shield TV
No touchscreen support, only keyboard and gamepad and joystick support.


=========
| Notes |
=========

If you're running this game under Vista or Windows 7 AND you're experiencing stuttering 
gameplay (this may or may not be), you need to change some settings on the file:
Right-click on the .exe file, go to  "properties", then tab "Compatibility" and change 
the following settings:

* Tick box "Run this program in compatibility mode for", and choose "Windows XP 
  (Service Pack 2)"
* Tick box "Disable visual themes"
* Tick box "Disable desktop composition"
* Tick box "Disable display scaling on high DPI settings"

Then, click "OK", and start the .exe file. Now, everything should run smoothly... 



===========
| Install |
===========
There's no install required, just execute OilsWell.exe to start game.
When game is started for the first time, it will create two save files.

Game works on most Windows systems.
Also it should work on most Android systems.
I tested it on Windows Vista, Windows 10, OUYA and Nvidia Shield TV (using OUYA controller).


========
| Info |
========
A remake of OILS WELL by Sierra Online 1983, with some added extras!
I added 8 new levels and some new enemies.

Keys:
- Use arrow keys and SPACE to control game. In option screen you can also use ENTER key.
- <F4> to change size of game window

You can also use a gamepad (I tested with a Logitech Cordless Rumblepad II). 
The existence of a gamepad is only checked when the game is started. So, make sure you
connect your gamepad, and then start the game. If a gamepad is found it will be stated
in the caption of the game window ("gamepad found!"). You can press <F4> to minimize 
the game screen to see the caption. 


------------
Intro screen
------------
Use arrow keys (up and down) or the D-pad to make choice. 
Use SPACE or button(1) to confirm.
You either start game, or go to option screen first.
Use LEFT or RIGHT arrow keys or the left or right on the D-pad to go to the highscore screens.
ESCAPE or button(4), button(9) of button(10) will exit the game.

--------------
Options screen
--------------
Choose option with arrow keys (up and down) or D-pad, and SPACE or button(1) to alter option. 
Use LEFT or RIGHT arrow keys or left or right on D-pad, or ENTER to exit option screen.

You can change the following game options:
1- Difficulty : REGULAR, UNLEADED and PREMIUM)
2- Maze set   : Arcade, Advanced, Mixed1, Mixed2 and Random
3- Pac        : ON/OFF
4- Drill zap  : ON/OFF
5- Life up    : ON/OFF

Under option 2, the following maze sets are available:
- arcade   : original levels only (8 levels)
- advanced : new levels only (8 levels)
- mixed1   : all levels (arcade + advanced, total 16 levels)
- mixed2   : all levels mixed differently dan mixed1
- random   : all levels, in totally random order (you can even get the same level twice in a row)

Option 3 and 4 will determine whether pac and zap will emerge or not.

Option 5 choosing whether you get an instant life up when reaching certain scores ("OFF"), or 
whether a life emerges in the screen, and you have to get it to get your life ("ON").


-------
In game
-------
Use arrow keys, D-pad or the left analogue stick to control the drill head. Use SPACE or button(1) 
to retract your pipe. Eat all the oil drops in the current level to progress to the next level. 

Watch out for the enemies that come from the side. They will hurt your pipe. To prevent this, you 
can eat the enemy with your drill head for extra points. Make sure you clear the level before your 
time runs out..

There is also a flashing bomb. This wont hurt your pipe, but WILL hurt your drill head.
Sometimes a flashing hourglass will emerge. Eat it to get extra time.

There is also a WHITE flashing power pill. When you eat it, 3 things can happen:
1 - All enemies on screen will disappear (but new enemies will emerge after a while)
2 - All enemies go slower for a while.
3 - both (1) and (2) happen.

When reaching a certain score, sometimes an extra life will pop up and moves through the screen. 
It looks like your drill head, and bounces a little. Eat it to earn an extra life.

There are also 2 extra enemies: pac and zap.
Pac will emerge sometimes, or after you eat a RED power will. Pac will chomp its way through the
level. Pac eats oil drops, enemies and also ground. Sometimes this comes in handy, since it opens 
new passage ways. Pac will hurt your drill head, but not your pipe. After a while it goes off screen.
You can only eat pac from behind. Hitting him from any other direction will hurt your drill head.

Zap will emerge sometimes. It will emerge on the left or right border of the screen and start 
flashing for a while. Then it will shoot forward. Zap will hurt your drill head, but not your pipe. 
It also zaps enemies.

ESCAPE or button(4), button(9) of button(10) will take you to the intro screen (thus
exitting your current game).


----------------
Highscore screen
----------------
If it's game over, and your score is high enough, you will be taken to the highscore screen.
Since the difficulty has 3 levels (REGULAR, UNLEADED and PREMIUM), there will be 3 separate
highscore tables.

Use arrowkeys LEFT and RIGHT or the D-pad left and right to move the letters.
Hit arrowkey DOWN or button(1) to enter letter.
Hit arrowkey UP or button(2) to remove the last leter.
Hit <ENTER> or button(3) to complete, and add your name and score to the list.

ESCAPE or button(4), button(9) of button(10) will take you to the intro screen.


========================================
| End of Readme                        |
========================================
